home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2001 May / SGI IRIX Base Documentation 2001 May.iso / usr / share / catman / p_man / catD / hwgraph.lblinfo.z / hwgraph.lblinfo
Encoding:
Text File  |  1998-10-30  |  7.1 KB  |  133 lines
  1.  
  2.  
  3.  
  4. hhhhwwwwggggrrrraaaapppphhhh....llllbbbblllliiiinnnnffffoooo((((DDDD3333XXXX))))                                      hhhhwwwwggggrrrraaaapppphhhh....llllbbbblllliiiinnnnffffoooo((((DDDD3333XXXX))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      _hhhh_wwww_gggg_rrrr_aaaa_pppp_hhhh_...._llll_bbbb_llll_iiii_nnnn_ffff_oooo_::::  hwgraph_info_add_LBL, hwgraph_info_remove_LBL,
  10.      hwgraph_info_replace_LBL, hwgraph_info_get_LBL, hwgraph_info_export_LBL,
  11.      hwgraph_info_unexport_LBL - manage labelled info in the hwgraph
  12.  
  13. SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  14.      ####iiiinnnncccclllluuuuddddeeee <<<<ssssyyyyssss////ttttyyyyppppeeeessss....hhhh>>>>
  15.      ####iiiinnnncccclllluuuuddddeeee <<<<ssssyyyyssss////hhhhwwwwggggrrrraaaapppphhhh....hhhh>>>>
  16.      ####iiiinnnncccclllluuuuddddeeee <<<<ssssyyyyssss////ddddddddiiii....hhhh>>>>
  17.  
  18.      ggggrrrraaaapppphhhh____eeeerrrrrrrroooorrrr____tttt
  19.      hhhhwwwwggggrrrraaaapppphhhh____iiiinnnnffffoooo____aaaadddddddd____LLLLBBBBLLLL((((vvvveeeerrrrtttteeeexxxx____hhhhddddllll____tttt _v_h_d_l,,,,
  20.                          cccchhhhaaaarrrr ****_i_n_f_o__n_a_m_e,,,,
  21.                          aaaarrrrbbbbiiiittttrrrraaaarrrryyyy____iiiinnnnffffoooo____tttt _i_n_f_o))));;;;
  22.  
  23.      ggggrrrraaaapppphhhh____eeeerrrrrrrroooorrrr____tttt
  24.      hhhhwwwwggggrrrraaaapppphhhh____iiiinnnnffffoooo____rrrreeeemmmmoooovvvveeee____LLLLBBBBLLLL((((vvvveeeerrrrtttteeeexxxx____hhhhddddllll____tttt _v_h_d_l,,,,
  25.                          cccchhhhaaaarrrr ****_i_n_f_o__n_a_m_e,,,,
  26.                          aaaarrrrbbbbiiiittttrrrraaaarrrryyyy____iiiinnnnffffoooo____tttt ****_i_n_f_o__p_t_r))));;;;
  27.  
  28.      ggggrrrraaaapppphhhh____eeeerrrrrrrroooorrrr____tttt
  29.      hhhhwwwwggggrrrraaaapppphhhh____iiiinnnnffffoooo____rrrreeeeppppllllaaaacccceeee____LLLLBBBBLLLL((((vvvveeeerrrrtttteeeexxxx____hhhhddddllll____tttt _v_h_d_l,,,,
  30.                          cccchhhhaaaarrrr ****_i_n_f_o__n_a_m_e,,,,
  31.                          aaaarrrrbbbbiiiittttrrrraaaarrrryyyy____iiiinnnnffffoooo____tttt _i_n_f_o,,,,
  32.                          aaaarrrrbbbbiiiittttrrrraaaarrrryyyy____iiiinnnnffffoooo____tttt ****_i_n_f_o__p_t_r))));;;;
  33.  
  34.      ggggrrrraaaapppphhhh____eeeerrrrrrrroooorrrr____tttt
  35.      hhhhwwwwggggrrrraaaapppphhhh____iiiinnnnffffoooo____ggggeeeetttt____LLLLBBBBLLLL((((vvvveeeerrrrtttteeeexxxx____hhhhddddllll____tttt _v_h_d_l,,,,
  36.                          cccchhhhaaaarrrr ****_i_n_f_o__n_a_m_e,,,,
  37.                          aaaarrrrbbbbiiiittttrrrraaaarrrryyyy____iiiinnnnffffoooo____tttt ****_i_n_f_o__p_t_r))));;;;
  38.  
  39.      ggggrrrraaaapppphhhh____eeeerrrrrrrroooorrrr____tttt
  40.      hhhhwwwwggggrrrraaaapppphhhh____iiiinnnnffffoooo____eeeexxxxppppoooorrrrtttt____LLLLBBBBLLLL((((vvvveeeerrrrtttteeeexxxx____hhhhddddllll____tttt _v_h_d_l,,,,
  41.                          cccchhhhaaaarrrr ****_i_n_f_o__n_a_m_e,,,,
  42.                          iiiinnnntttt _n_u_m_b_y_t_e_s))));;;;
  43.  
  44.      ggggrrrraaaapppphhhh____eeeerrrrrrrroooorrrr____tttt
  45.      hhhhwwwwggggrrrraaaapppphhhh____iiiinnnnffffoooo____uuuunnnneeeexxxxppppoooorrrrtttt____LLLLBBBBLLLL((((vvvveeeerrrrtttteeeexxxx____hhhhddddllll____tttt _v_h_d_l,,,,
  46.                          cccchhhhaaaarrrr ****_i_n_f_o__n_a_m_e))));;;;
  47.  
  48.    AAAArrrrgggguuuummmmeeeennnnttttssss
  49.      _i_n_f_o        Arbitrary info value to associate with _i_n_f_o__n_a_m_e in the
  50.                  future.
  51.  
  52.      _i_n_f_o__n_a_m_e   Address of the label string to be created or queried.
  53.  
  54.      _i_n_f_o__p_t_r    pointer to a field to receive the info currently associated
  55.                  with _i_n_f_o__n_a_m_e, or NULL if the current value is not needed.
  56.  
  57.      _n_u_m_b_y_t_e_s    Length of information addressed by the pointer associated
  58.                  with _i_n_f_o__n_a_m_e, or 0 to indicate that the info info word
  59.                  itself is the exported data.
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. hhhhwwwwggggrrrraaaapppphhhh....llllbbbblllliiiinnnnffffoooo((((DDDD3333XXXX))))                                      hhhhwwwwggggrrrraaaapppphhhh....llllbbbblllliiiinnnnffffoooo((((DDDD3333XXXX))))
  71.  
  72.  
  73.  
  74.      _v_h_d_l        Handle of an existing vertex.
  75.  
  76. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  77.      These functions operate on a vertex in the hardware graph to add, remove,
  78.      atomically replace, retrieve, export, and unexport labeled information.
  79.      Typical device drivers do not need to use any of these operations.
  80.  
  81.      Exported labelled information on a vertex is visible to user-level
  82.      processes as an extended file attribute (see _a_t_t_r__g_e_t(2)) on the /hw
  83.      special file corresponding to that vertex.  By this means, the driver can
  84.      export data to programs running as user-level processes.
  85.  
  86. DDDDIIIIAAAAGGGGNNNNOOOOSSSSTTTTIIIICCCCSSSS
  87.      All return GRAPH_SUCCESS when the operation completes successfully, or a
  88.      failure code as defined in _h_w_g_r_a_p_h._i_n_t_r_o(D4X) when the operation does not
  89.      complete  successfully.
  90.  
  91. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  92.      attr_get(2), hwgraph(4), hwgraph.intro(D4X).
  93.  
  94.  
  95.  
  96.  
  97.  
  98.  
  99.  
  100.  
  101.  
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.                                                                         PPPPaaaaggggeeee 2222
  130.  
  131.  
  132.  
  133.